Long

class Long : Number, Comparable<Long>

Represents a 64-bit signed integer. On the JVM, non-nullable values of this type are represented as values of the primitive type long.

Types

Companion
Link copied to clipboard
object Companion

Functions

and
Link copied to clipboard
infix fun and(other: Long): Long

Performs a bitwise AND operation between the two values.

compareTo
Link copied to clipboard
operator fun compareTo(other: Byte): Int
operator fun compareTo(other: Double): Int
operator fun compareTo(other: Float): Int
operator fun compareTo(other: Int): Int
open operator override fun compareTo(other: Long): Int
operator fun compareTo(other: Short): Int

Compares this value with the specified value for order. Returns zero if this value is equal to the specified other value, a negative number if it's less than other, or a positive number if it's greater than other.

dec
Link copied to clipboard
operator fun dec(): Long

Decrements this value.

div
Link copied to clipboard
operator fun div(other: Byte): Long
operator fun div(other: Int): Long
operator fun div(other: Long): Long
operator fun div(other: Short): Long

Divides this value by the other value, truncating the result to an integer that is closer to zero.

operator fun div(other: Double): Double
operator fun div(other: Float): Float

Divides this value by the other value.

inc
Link copied to clipboard
operator fun inc(): Long

Increments this value.

inv
Link copied to clipboard
fun inv(): Long

Inverts the bits in this value.

minus
Link copied to clipboard
operator fun minus(other: Byte): Long
operator fun minus(other: Double): Double
operator fun minus(other: Float): Float
operator fun minus(other: Int): Long
operator fun minus(other: Long): Long
operator fun minus(other: Short): Long

Subtracts the other value from this value.

or
Link copied to clipboard
infix fun or(other: Long): Long

Performs a bitwise OR operation between the two values.

plus
Link copied to clipboard
operator fun plus(other: Byte): Long
operator fun plus(other: Double): Double
operator fun plus(other: Float): Float
operator fun plus(other: Int): Long
operator fun plus(other: Long): Long
operator fun plus(other: Short): Long

Adds the other value to this value.

rangeTo
Link copied to clipboard
operator fun rangeTo(other: Byte): LongRange
operator fun rangeTo(other: Int): LongRange
operator fun rangeTo(other: Long): LongRange
operator fun rangeTo(other: Short): LongRange

Creates a range from this value to the specified other value.

rem
Link copied to clipboard
operator fun rem(other: Byte): Long
operator fun rem(other: Double): Double
operator fun rem(other: Float): Float
operator fun rem(other: Int): Long
operator fun rem(other: Long): Long
operator fun rem(other: Short): Long

Calculates the remainder of truncating division of this value by the other value.

Since Kotlin

1.1
shl
Link copied to clipboard
infix fun shl(bitCount: Int): Long

Shifts this value left by the bitCount number of bits.

shr
Link copied to clipboard
infix fun shr(bitCount: Int): Long

Shifts this value right by the bitCount number of bits, filling the leftmost bits with copies of the sign bit.

times
Link copied to clipboard
operator fun times(other: Byte): Long
operator fun times(other: Double): Double
operator fun times(other: Float): Float
operator fun times(other: Int): Long
operator fun times(other: Long): Long
operator fun times(other: Short): Long

Multiplies this value by the other value.

toByte
Link copied to clipboard
open override fun toByte(): Byte

Converts this Long value to Byte.

toChar
Link copied to clipboard
@DeprecatedSinceKotlin(warningSince = "1.5")
open override fun toChar(): Char

Converts this Long value to Char.

toDouble
Link copied to clipboard
open override fun toDouble(): Double

Converts this Long value to Double.

toFloat
Link copied to clipboard
open override fun toFloat(): Float

Converts this Long value to Float.

toInt
Link copied to clipboard
open override fun toInt(): Int

Converts this Long value to Int.

toLong
Link copied to clipboard
open override fun toLong(): Long

Returns this value.

toShort
Link copied to clipboard
open override fun toShort(): Short

Converts this Long value to Short.

unaryMinus
Link copied to clipboard
operator fun unaryMinus(): Long

Returns the negative of this value.

unaryPlus
Link copied to clipboard
operator fun unaryPlus(): Long

Returns this value.

ushr
Link copied to clipboard
infix fun ushr(bitCount: Int): Long

Shifts this value right by the bitCount number of bits, filling the leftmost bits with zeros.

xor
Link copied to clipboard
infix fun xor(other: Long): Long

Performs a bitwise XOR operation between the two values.

Extensions

absoluteValue
Link copied to clipboard
expect val Long.absoluteValue: Long

Returns the absolute value of this value.

actual val Long.absoluteValue: Long

Returns the absolute value of this value.

actual val Long.absoluteValue: Long

Returns the absolute value of this value.

actual val Long.absoluteValue: Long

Returns the absolute value of this value.

coerceAtLeast
Link copied to clipboard
fun Long.coerceAtLeast(minimumValue: Long): Long

Ensures that this value is not less than the specified minimumValue.

coerceAtMost
Link copied to clipboard
fun Long.coerceAtMost(maximumValue: Long): Long

Ensures that this value is not greater than the specified maximumValue.

coerceIn
Link copied to clipboard
fun Long.coerceIn(minimumValue: Long, maximumValue: Long): Long

Ensures that this value lies in the specified range minimumValue..maximumValue.

fun Long.coerceIn(range: ClosedRange<Long>): Long

Ensures that this value lies in the specified range.

convert
Link copied to clipboard
inline external fun <R : Any> Long.convert(): R
countLeadingZeroBits
Link copied to clipboard
expect fun Long.countLeadingZeroBits(): Int

Counts the number of consecutive most significant bits that are zero in the binary representation of this Long number.

actual inline fun Long.countLeadingZeroBits(): Int

Counts the number of consecutive most significant bits that are zero in the binary representation of this Long number.

actual fun Long.countLeadingZeroBits(): Int

Counts the number of consecutive most significant bits that are zero in the binary representation of this Long number.

actual fun Long.countLeadingZeroBits(): Int

Counts the number of consecutive most significant bits that are zero in the binary representation of this Long number.

countOneBits
Link copied to clipboard
expect fun Long.countOneBits(): Int

Counts the number of set bits in the binary representation of this Long number.

actual inline fun Long.countOneBits(): Int

Counts the number of set bits in the binary representation of this Long number.

actual fun Long.countOneBits(): Int

Counts the number of set bits in the binary representation of this Long number.

actual external fun Long.countOneBits(): Int

Counts the number of set bits in the binary representation of this Long number.

countTrailingZeroBits
Link copied to clipboard
expect fun Long.countTrailingZeroBits(): Int

Counts the number of consecutive least significant bits that are zero in the binary representation of this Long number.

actual inline fun Long.countTrailingZeroBits(): Int

Counts the number of consecutive least significant bits that are zero in the binary representation of this Long number.

actual fun Long.countTrailingZeroBits(): Int

Counts the number of consecutive least significant bits that are zero in the binary representation of this Long number.

actual fun Long.countTrailingZeroBits(): Int

Counts the number of consecutive least significant bits that are zero in the binary representation of this Long number.

days
Link copied to clipboard
val Long.days: Duration

Returns a Duration equal to this Long number of days.

downTo
Link copied to clipboard
infix fun Long.downTo(to: Byte): LongProgression
infix fun Long.downTo(to: Int): LongProgression
infix fun Long.downTo(to: Long): LongProgression
infix fun Long.downTo(to: Short): LongProgression

Returns a progression from this value down to the specified to value with the step -1.

floorDiv
Link copied to clipboard
inline fun Long.floorDiv(other: Byte): Long
inline fun Long.floorDiv(other: Short): Long
inline fun Long.floorDiv(other: Int): Long
inline fun Long.floorDiv(other: Long): Long

Divides this value by the other value, flooring the result to an integer that is closer to negative infinity.

hours
Link copied to clipboard
val Long.hours: Duration

Returns a Duration equal to this Long number of hours.

microseconds
Link copied to clipboard
val Long.microseconds: Duration

Returns a Duration equal to this Long number of microseconds.

milliseconds
Link copied to clipboard
val Long.milliseconds: Duration

Returns a Duration equal to this Long number of milliseconds.

minutes
Link copied to clipboard
val Long.minutes: Duration

Returns a Duration equal to this Long number of minutes.

mod
Link copied to clipboard
inline fun Long.mod(other: Byte): Byte
inline fun Long.mod(other: Short): Short
inline fun Long.mod(other: Int): Int
inline fun Long.mod(other: Long): Long

Calculates the remainder of flooring division of this value by the other value.

nanoseconds
Link copied to clipboard
val Long.nanoseconds: Duration

Returns a Duration equal to this Long number of nanoseconds.

rotateLeft
Link copied to clipboard
expect fun Long.rotateLeft(bitCount: Int): Long

Rotates the binary representation of this Long number left by the specified bitCount number of bits. The most significant bits pushed out from the left side reenter the number as the least significant bits on the right side.

@ExperimentalStdlibApi
actual inline fun Long.rotateLeft(bitCount: Int): Long

Rotates the binary representation of this Long number left by the specified bitCount number of bits. The most significant bits pushed out from the left side reenter the number as the least significant bits on the right side.

@ExperimentalStdlibApi
actual fun Long.rotateLeft(bitCount: Int): Long

Rotates the binary representation of this Long number left by the specified bitCount number of bits. The most significant bits pushed out from the left side reenter the number as the least significant bits on the right side.

@ExperimentalStdlibApi
actual fun Long.rotateLeft(bitCount: Int): Long

Rotates the binary representation of this Long number left by the specified bitCount number of bits. The most significant bits pushed out from the left side reenter the number as the least significant bits on the right side.

rotateRight
Link copied to clipboard
expect fun Long.rotateRight(bitCount: Int): Long

Rotates the binary representation of this Long number right by the specified bitCount number of bits. The least significant bits pushed out from the right side reenter the number as the most significant bits on the left side.

@ExperimentalStdlibApi
actual inline fun Long.rotateRight(bitCount: Int): Long

Rotates the binary representation of this Long number right by the specified bitCount number of bits. The least significant bits pushed out from the right side reenter the number as the most significant bits on the left side.

@ExperimentalStdlibApi
actual inline fun Long.rotateRight(bitCount: Int): Long

Rotates the binary representation of this Long number right by the specified bitCount number of bits. The least significant bits pushed out from the right side reenter the number as the most significant bits on the left side.

@ExperimentalStdlibApi
actual inline fun Long.rotateRight(bitCount: Int): Long

Rotates the binary representation of this Long number right by the specified bitCount number of bits. The least significant bits pushed out from the right side reenter the number as the most significant bits on the left side.

seconds
Link copied to clipboard
val Long.seconds: Duration

Returns a Duration equal to this Long number of seconds.

sign
Link copied to clipboard
expect val Long.sign: Int

Returns the sign of this value:

actual val Long.sign: Int

Returns the sign of this value:

actual val Long.sign: Int

Returns the sign of this value:

actual val Long.sign: Int

Returns the sign of this value:

takeHighestOneBit
Link copied to clipboard
expect fun Long.takeHighestOneBit(): Long

Returns a number having a single bit set in the position of the most significant set bit of this Long number, or zero, if this number is zero.

actual inline fun Long.takeHighestOneBit(): Long

Returns a number having a single bit set in the position of the most significant set bit of this Long number, or zero, if this number is zero.

actual fun Long.takeHighestOneBit(): Long

Returns a number having a single bit set in the position of the most significant set bit of this Long number, or zero, if this number is zero.

actual fun Long.takeHighestOneBit(): Long

Returns a number having a single bit set in the position of the most significant set bit of this Long number, or zero, if this number is zero.

takeLowestOneBit
Link copied to clipboard
expect fun Long.takeLowestOneBit(): Long

Returns a number having a single bit set in the position of the least significant set bit of this Long number, or zero, if this number is zero.

actual inline fun Long.takeLowestOneBit(): Long

Returns a number having a single bit set in the position of the least significant set bit of this Long number, or zero, if this number is zero.

actual fun Long.takeLowestOneBit(): Long

Returns a number having a single bit set in the position of the least significant set bit of this Long number, or zero, if this number is zero.

actual fun Long.takeLowestOneBit(): Long

Returns a number having a single bit set in the position of the least significant set bit of this Long number, or zero, if this number is zero.

toBigDecimal
Link copied to clipboard
inline fun Long.toBigDecimal(): BigDecimal
inline fun Long.toBigDecimal(mathContext: MathContext): BigDecimal

Returns the value of this Long number as a BigDecimal.

toBigInteger
Link copied to clipboard
inline fun Long.toBigInteger(): BigInteger

Returns the value of this Long number as a BigInteger.

toCPointer
Link copied to clipboard
fun <T : CPointed> Long.toCPointer(): CPointer<T>?
toDuration
Link copied to clipboard
fun Long.toDuration(unit: DurationUnit): Duration

Returns a Duration equal to this Long number of the specified unit.

toString
Link copied to clipboard
expect fun Long.toString(radix: Int): String

Returns a string representation of this Long value in the specified radix.

actual inline fun Long.toString(radix: Int): String

Returns a string representation of this Long value in the specified radix.

actual fun Long.toString(radix: Int): String

Returns a string representation of this Long value in the specified radix.

actual inline fun Long.toString(radix: Int): String

Returns a string representation of this Long value in the specified radix.

toUByte
Link copied to clipboard
inline fun Long.toUByte(): UByte

Converts this Long value to UByte.

toUInt
Link copied to clipboard
inline fun Long.toUInt(): UInt

Converts this Long value to UInt.

toULong
Link copied to clipboard
inline fun Long.toULong(): ULong

Converts this Long value to ULong.

toUShort
Link copied to clipboard
inline fun Long.toUShort(): UShort

Converts this Long value to UShort.

until
Link copied to clipboard
infix fun Long.until(to: Byte): LongRange
infix fun Long.until(to: Int): LongRange
infix fun Long.until(to: Long): LongRange
infix fun Long.until(to: Short): LongRange

Returns a range from this value up to but excluding the specified to value.